(with-selected-window): Doc fix.

diff --git a/lisp/subr.el b/lisp/subr.el
index f2c643b669004b371dca5543acbc0ae76112422e..9dd1e4152120054df5a0bf3df25524976f668ad3 100644 (file)
--- a/lisp/subr.el
+++ b/lisp/subr.el
@@ -1799,6 +1799,12 @@ See also `with-temp-buffer'."
   "Execute the forms in BODY with WINDOW as the selected window.
 The value returned is the value of the last form in BODY.
 This does not alter the buffer list ordering.
+This function saves and restores the selected window, as well as
+the selected window in each frame.  If the previously selected
+window of some frame is no longer live at the end of BODY, that
+frame's selected window is left alone.  If the selected window is
+no longer live, then whatever window is selected at the end of
+BODY remains selected.
 See also `with-temp-buffer'."
   (declare (indent 1) (debug t))
   ;; Most of this code is a copy of save-selected-window.